home *** CD-ROM | disk | FTP | other *** search
/ STraTOS 1997 April & May / STraTOS 1 - 1997 April & May.iso / CD01 / INTERNET / BROWSERS / XURL / XURL.TXT < prev    next >
Encoding:
Text File  |  1997-01-02  |  5.1 KB  |  137 lines
  1.                               XURL
  2.                                                     
  3.                         ╜ COPYRIGHT 1996
  4.                                by
  5.                           Gary A. Priest
  6.  
  7. XURL - The URL eXtractor 
  8. ------------------------
  9. XURL (pronounced ZURL) extracts URLs such as http:// from a file and
  10. adds them to a html document which can be loaded into a browser.
  11. The URL can then be clicked on and the browser will jump straight to
  12. the given URL.
  13. This means that you no longer have to write them down and then re-key 
  14. them into your browser. XURL makes it easy.
  15.  
  16.  
  17. INSTALLATION
  18. ------------
  19. 1. Copy the XURL folder onto your hard drive.
  20.  
  21. 2. Run XURL:
  22.    (a) Set the 'Source' path to point to whichever file you are going to
  23.        extract URLs from. The filename can include wildcards ie. *.* 
  24.        to process all files.
  25.    (b) Set the 'HTML' path to point to XURLHOME.HTM
  26.  
  27. 3. Run CAB:
  28.    (a) Set the homepage to XURLHOME.HTM (if you want it as your home page).
  29.    (b) Set XURL.PRG as an external viewer for *.XRL (this enables you to
  30.        click on the 'Run XURL' link and run XURL from within CAB.
  31.        NB. XURLHOME.HTM and XURL.XRL must exist in the same folder.
  32.  
  33. 4. Environment Variables:
  34.    The following environment variables must exist for XURL to be able 
  35.    to launch a web browser:
  36.  
  37.    eg. BROWSER=C:\CAB\CAB.APP
  38.        EMAIL=C:\CAB\CAB.APP
  39.        
  40.    Single TOS users can either get hold of programs such as GEMENV 
  41.    and SETENV or can use the file VARS.ENV. This file must exist in 
  42.    the same path as XURL.PRG to be effective.
  43.    Edit file VARS.ENV to point to whichever programs you wish to use.
  44.    
  45.    Magic users should add the following lines to MAGX.INF
  46.    #_ENV BROWSER=C:\CAB\CAB.APP
  47.    #_ENV EMAIL=C:\CAB\CAB.APP
  48.  
  49.    MultiTOS or Geneva users should add the following lines to GEM.CNF
  50.    setenv BROWSER=C:\CAB\CAB.APP
  51.    setenv EMAIL=C:\CAB\CAB.APP
  52.  
  53.  
  54. USING XURL
  55. ----------
  56. As long as the paths are set up correctly, using XURL is simple.
  57. I always 'extract' emails and news to the same file from Oasis and have
  58. the 'Source' path point to that. As long as you always use the same file
  59. you shouldn't have to change the settings in XURL each time you
  60. use it.
  61.  
  62. Click on 'Ok' and XURL will extract any URLs from the source file and
  63. add them to the HTML file specified.
  64.  
  65. 'Append' means that they will be added on to the end of any existing ones
  66. whereas 'Replace' will replace the existing HTML file if it exists.
  67.  
  68. The resulting HTML file can be loaded into CAB manually or automatically
  69. if you have it set to be your homepage.
  70.  
  71. Now, simply click on the link (assuming STiK is connected) and you'll go
  72. straight to it.
  73.  
  74. XURL can be run from the desktop or from within CAB by clicking on
  75. 'Execute XURL' (remember to click reload on return to CAB).
  76.  
  77. Files can also be dragged onto the XURL program icon from the desktop.
  78. This results in it being placed in XURL's 'Source' path ready for 
  79. extraction. Files ending with .xrl or .XRL will be ignored so that 
  80. XURL can be run from CAB as above.
  81.  
  82.  
  83. LAUNCHING A BROWSER AFTER EXTRACTION
  84. ------------------------------------
  85. The extracted .html file ie. (XURLHOME.HTM) can be viewed immediately 
  86. after extraction in your web browser.
  87.  
  88. An environment variable (BROWSER=) must be installed (see installation 
  89. notes) for this feature to work. This variable tells XURL the location 
  90. of your web browser.
  91.  
  92. If the web browser is already in memory then VASTART is used else the 
  93. web browser will be launched via shel_write.
  94.  
  95.  
  96. ALL ABOUT THE NEW "ABOUT" WINDOW
  97. --------------------------------
  98. This is a bit gimmicky but is going to be a standard in all of my 
  99. programs from now on. As the Pentium advertisements keep saying, this 
  100. program is 'Internet Connected' :-)
  101.  
  102. Both the email address and the URL can be selected and copied to the 
  103. GEM clipboard via (CTRL C or CTRL Insrt). This allows them to be 
  104. pasted into any programs that support 'pasting' into their fields 
  105. such as CAB. Saves all that typing!
  106.  
  107. For people who are really lazy, try double clicking on them.
  108. The browser will be launched and passed a mailto: or http:.
  109. Hence if you are ONLINE at the time, the web browser will go straight 
  110. to my web site. Or in the case of the email address, you'll be all 
  111. ready to start typing an email to me!
  112. Two environment variables (BROWSER= & EMAIL=) must be installed (see
  113. installation notes) for this feature to work. This variable tells XURL
  114. the location of your web browser and of your email program.
  115.  
  116.  
  117. THE USUAL DISCLAIMER
  118. --------------------
  119. This  program  is  freely redistributable for  use  by  absolutely 
  120. anyone who feels they need it.
  121.  
  122. Any damage caused by use of this program either directly or
  123. indirectly is the sole responsibility of the user.
  124.  
  125.  
  126. FREEWARE
  127. -------------------------------------
  128. XURL is FREEWARE. I make no charge for using XURL although an email to
  129. say that you find it useful might be nice. :-)
  130.  
  131. If you find any bugs in XURL or have any suggestions, then drop me an 
  132. email.
  133.  
  134. Gary Priest
  135. gary@the-gap.demon.co.uk
  136. http://www.the-gap.demon.co.uk/
  137.